<text><span class="style1">he scrolling list to the right names the services contained in this stack. To view and/or edit any of the services click anywhere on the line that contains the name of the service .
</span><span class="style13">
(To rebuild the list, use the 'Rebuild
Service List' option in the File menu)
</span><span class="style1">
To create a new service click on the button beneath the scrolling list.</span></text>
</content>
<content>
<layer>background</layer>
<id>10</id>
<text>Position the mouse over the label,button or field about which you require information</text>
</content>
<content>
<layer>background</layer>
<id>13</id>
<text>Example Service #1
Example Service #2</text>
</content>
<name>Menu</name>
<script></script>
</card>
card_4252.xml
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE card PUBLIC "-//Apple, Inc.//DTD card V 2.0//EN" "" >
</span><span class="style6">A Script consists of one or more command lines, each of which may contain up to five elements. Each script element is described below :
</span><span class="style7">
</span><span class="style8">1. Command Element.
</span><span class="style6">
If present, the command element is interpreted as follows -
If the command element contains the word 'PASSWORD' then the word is replaced by the contents of the script variable PASSWORD (see sub-section 'Action to be taken' below) and the resulting character string is sent to the service.
If the first character of the command element = "∞" (option 5) then a long break signal is sent to the service otherwise the command element is edited as per the following rules and the resultant character string is sent to the service.
If the command is proceeded by a ΓÇ£@ΓÇ¥ (shift 2) character then the remaining command element is to be sent slowly to the service, i.e. 6 characters per second.
The command element may contain character pairs that together define a control character. That is, the character “©” (option g) is interpreted as defining the following character to be a control character. The following character is converted to its numeric control value by subtracting 64 from its character value, e.g. ©A = control A and ©[ = escape.
All occurrences of the character “ ®” (option r) are replaced by carriage- returns.
If the command element contains a “Ω” (option z) character then this is interpreted as a request to block out the remaining characters of the element with 'bullets' (•). This facility is intended for those cases where script execution display has been specified and sensitive data (e.g. passwords) is contained within the command.
This element may contain up to 3 sub-elements, they are as follows :
</span><span class="style8">Time period.
</span><span class="style6">
The amount of time, in seconds to allow for a successful response to the transmitted command string (N.B. A successful response is defined as input being received that matches one of the character strings defined in point 3 below). If the time limit is exceeded a variety of actions may be taken depending on the setting of the following sub-element.
</span><span class="style8">Action to be Taken.
</span><span class="style6">
This sub-element defines the action to be taken if no valid response is returned from the service in the specified time period. The various action codes are as follows :
</span><span class="style7">C</span><span class="style6"> Continue execution at the relative script line defined by the next sub-element.
</span><span class="style7"> P </span><span class="style6">Request input from the operator via a 'Password' dialog box. The operator response is masked
for security and the resulting input is loaded (with carriage-return attached) into a variable called
PASSWORD. This variable may then be referred to in the command element (see above). The
script is continued from the script line defined by the next sub-element.
</span><span class="style7">X </span><span class="style6">Terminate the script successfully.
</span><span class="style7">A</span><span class="style6"> Abort the script and display an error message.
</span><span class="style7">E</span><span class="style6"> Ask the operator if a further time period is required (to allow for slow processors).
</span><span class="style7">R</span><span class="style6"> Decrement the retry counter. If the resulting value is zero then abort the script and display an
error message, otherwise continue from the relative script line defined by the next sub-element.
</span><span class="style8">Relative Line Number.</span><span class="style10">
</span><span class="style6">
</span><span class="style7"> </span><span class="style6">This</span><span class="style7"> </span><span class="style6">is a positive or negative value that is added to the current line number to obtain the new script line number from which to continue execution. For example, to continue execution from the script line immediately prior to current one use value -1, to continue execution from the line following the current one use value 1.
The script line may contain up to 3 further elements. Each of the elements defines a character string to search for in the input received from the service. Each element consists of up to 3 sub-elements as defined below :
</span><span class="style8">Search String.
</span><span class="style6">
The character string to search for in the service output. The string may contain character pairs that together define a control character. That is, the character “©” (option g) is interpreted as defining the following character to be a control character. The following character is converted to its numeric control value by subtracting 64 from its character value, e.g. ©A = control A and ©[ = escape.The search is case sensitive.
</span><span class="style8">Action to be Taken.
</span><span class="style6">
This sub-element defines the action to be taken if search string is detected in the service output :
</span><span class="style7">C</span><span class="style6"> Continue execution at the relative script line defined by the next sub-element.
</span><span class="style7">X </span><span class="style6">Terminate the script successfully.
</span><span class="style7">A</span><span class="style6"> Abort the script and display an error message.
</span><span class="style7"> P </span><span class="style6">Request input from the operator via a 'Password' dialog box. The operator response is masked
for security and the resulting input is loaded (with carriage-return attached) into a variable called
PASSWORD. This variable may then be referred to in the command element (see above). The
script is continued from the script line defined by the next sub-element.</span><span class="style7">
</span><span class="style6">
</span><span class="style8">Relative Line Number.</span><span class="style6">
</span><span class="style7"> </span><span class="style6">This</span><span class="style7"> </span><span class="style6">is a positive or negative value that is added to the current line number to obtain the new script line number from which to continue execution.</span></text>
<text>This is a simple example service that contains neither a login or logout script. The service is configured to use the Serial Connection tool set for 9600 baud and the VT102 Terminal Emulation tool.
<text>This example service contains a typical unix style login and logout script. The login script is described in detail in the xLibrary User Manual. The service is configured to use the Serial Connection tool set for 9600 baud and the VT102 terminal Emulation tool.</text>
